home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / bbs_game / btrip22.zip / BATTLE.DOC next >
Text File  |  1996-01-10  |  22KB  |  523 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.      _____________________________________________________________________
  19.  
  20.  
  21.  
  22.  
  23.                                Battle Trip v2.2
  24.  
  25.                                   Written by
  26.  
  27.                                  Rob Williams
  28.                                  WCS Software
  29.  
  30.  
  31.      _____________________________________________________________________
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                           
  52.                             Copyright Notice
  53.                             ----------------
  54.  
  55.      This door game is distributed under the SHAREWARE concept.  This
  56.      concept gives you the chance to "try before you buy", and see if it
  57.      meets your needs.  
  58.  
  59.      I've decided to break away from the standard "30 day trial period"
  60.      that many door authors are using and instead go to a much simpler 
  61.      and more realistic policy. This is simply; Try it on your BBS.
  62.      If you like it and your users like it, then register it.  If it's not 
  63.      good enough to register, then delete it.  
  64.  
  65.      While I'd like you to register my doors as soon as possible, I'm also 
  66.      realistic enough to know that different boards have different requirements
  67.      and interests, and sometimes it takes longer befor a game catches on, or a
  68.      sysop can get to the Doors on his list to register.  And frankly, I'd 
  69.      rather you ran it for awhile and register, than try it for a short 
  70.      period of time and delete it. Nobody wins that way...I lose out on a 
  71.      registration and your users lose out on the chance of having the 
  72.      registered door to play.
  73.  
  74.      The above "extended trial" statement was copied with permission from
  75.      Mike Jordan of M&S Doors.
  76.  
  77.      As a shareware  program, Battle Trip may be freely distributed.
  78.      Shareware distributors may distribute copies of Battle Trip on disk 
  79.      for a modest disk duplication charge not to exceed $4 per disk.
  80.  
  81.  
  82.  
  83.                                     Warranty
  84.                                     --------
  85.  
  86.      Battle Trip is distributed on as as is basis.  In no event will
  87.      Rob Williams or WCS Software be liable to you for damages, including 
  88.      any loss of profits, lost savings, or other incidental or  
  89.      consequential damages arising out of your use of or inability to use
  90.      this program, even if Rob Williams, WCS Software, or an authorized 
  91.      representative has been advised of the possibility of such damages.  
  92.      Rob Williams and WCS Software will not be liable for any such claim 
  93.      by any other party.
  94.  
  95.  
  96.                             Features of Battle Trip
  97.                             -----------------------
  98.      Battle Trip is fully InterBBS capable, with very little attention
  99.      needed from the sysop.  Automatic messaging to/from the game hub
  100.      in Fido standard *.MSG format messages with file attachments.
  101.  
  102.      Assembly language serial input/output routines for maximum speed.
  103.  
  104.      Fully supports high speed modems: 16550 FIFO buffering and locked
  105.      serial ports.
  106.  
  107.      Built in ANSI terminal emulator.  No need to have ANSI.SYS loaded in
  108.      memory.
  109.  
  110.      DesqView, Windows, and OS/2 aware.
  111.  
  112.      Supports all of the most popular door data file formats:
  113.      TriBBS, PCBoard, GAP  (DOOR.SYS), Spitfire, WildCat!,  RBBS, and WWIV.
  114.  
  115.      ANSI and ASCII Bulletins of high scorers.
  116.  
  117.      Automatic monthly maintenance with no intervention from the Sysop.
  118.  
  119.      Supports play ahead and make up days when registered.  This is
  120.      completely sysop configurable.
  121.  
  122.      Battle Trip is Multinode Aware!
  123.  
  124.  
  125.                          Files used in the Program
  126.                          -------------------------
  127.  
  128.      BATTLE.EXE    -   The main battle trip program
  129.  
  130.      REGISTER.FRM  -   Information on registration
  131.  
  132.      SAMPLE.CFG    -   Sample configuration file
  133.  
  134.      SAMPLE.BAT    -   Sample batch file to run battle trip
  135.  
  136.      HISCORE.DAT   -   Created when the program runs-contains hi score info
  137.  
  138.      USER.DAT      -   Created when the program runs-contains user info
  139.  
  140.      BATTLE.KEY    -   Key file for registered versions
  141.  
  142.      BATTLE.USE    -   Created when the game is running, will be deleted
  143.                        when the user exits normally.
  144.                        (only in single user/non-registered versions)
  145.  
  146.      ************************************************************************
  147.      ** IMPORTANT - The game will not run if this file (BATTLE.USE) exists **
  148.      ************************************************************************
  149.  
  150.      BATTLE.HLP    -   Help file for the game.  When the Instructions option
  151.                        is selected, this file is displayed.  You may edit
  152.                        this file if you wish.  It is a plain ASCII text file.
  153.  
  154.      BATTLE.HIS    -   History of the product.  Shows what enhancements were
  155.                        made in what version.
  156.  
  157.      WCSINFO.TXT   -   A text file explaining more about WCS Software and
  158.                        showing all currently available WCS Software programs.
  159.  
  160.      READ.ME       -   A brief text file explaining how to get up and running
  161.                        quickly.
  162.  
  163.      NOBEEP        -   If this file exists in the game directory, the game
  164.                        not make noises when you play it (either remotely or
  165.                        locally)  Good for those sysops who play games locally
  166.                        late at night <grin>.
  167.  
  168.      INTERBBS.DOC  -   A document explaining how to set up Battle Trip to
  169.                        run in an InterBBS League.
  170.  
  171.      ***************************************************************************
  172.      *****  IT IS VERY IMPORTANT TO READ THIS FILE FULLY BEFORE ATTEMPTING  ****
  173.      *****  TO RUN BATTLE TRIP IN AN INTERBBS LEAGUE.                       ****
  174.      *****  YOU SHOULD ALSO BE WELL VERSED IN FIDO TERMINOLOGY.             ****
  175.      ***************************************************************************
  176.  
  177.      DBRIDGE.HLP   -   Help file for people running D'Bridge mailers.  Also
  178.                        helpful as a fallback if you have problems getting
  179.                        the score files automatically processed. (for InterBBS
  180.                        use only)
  181.  
  182.      WCSDOORS.FAQ  -   Frequently asked questions about WCS Software Doors.
  183.                        If you are having a problem with either WCSOil or
  184.                        the InterBBS portion, read this file first for help.
  185.  
  186.                            Setting up Battle Trip
  187.                            ----------------------
  188.  
  189.      Battle Trip is run by  entering a command similar to the
  190.      following:
  191.  
  192.      BATTLE BATTLE.CFG
  193.  
  194.      The configuration file can have any name you choose, but it must
  195.      reside in the same directory as the door.  The configuration file is
  196.      an ASCII text file with the following format:
  197.  
  198.      Line 1:   Door data file type.
  199.      Line 2:   Path to the door data file(s).
  200.      Line 3:   BBS name.
  201.      Line 4:   Sysop's name.
  202.      Line 5:   Locked baud rate.
  203.      Line 6:   ASCII High Score Bulletin Name
  204.      Line 7:   ANSI High Score Bulletin Name
  205.      Line 8:   Comments File Name
  206.      Line 9:   Number of Games per day
  207. *    Line 10:  Number of extra days allowed for make up days
  208. *    Line 11:  Day to start playing make up days-31 to disable
  209.      Line 12:  Write log files (explained below)
  210. *    Line 13:  Line to display a message (donated by, etc)
  211.      Line 14:  Name you want the computer opponent to have
  212.      Line 15:  InterBBS Play (Y or N)
  213.  
  214.      Lines with a "*" to the left indicate features only present in the
  215.      registered version of the program.  *** The lines must be present,
  216.      even if the door is not registered. ***
  217.  
  218.      As illustrated above, the door's data file type is specified in line 1
  219.      and can be PCB for PCBoard, GAP for GAP (DOOR.SYS), SF for Spitfire,
  220.      RBBS for RBBS, WC for WildCat!, TRIBBS for TriBBS, or WWIV for WWIV.
  221.      The locked baud rate is specified in line 5.  If you don't lock your
  222.      serial port, you must specify 0 for the locked baud rate.
  223.      The following is a sample door configuration file:
  224.  
  225.      ************************************************************************
  226.      ** IMPORTANT - If you are running WC 4.x, use the GAP drop file       **
  227.      ************************************************************************
  228.  
  229.      WC                             <== BBS Type
  230.      C:\WC30\WCWORK\NODE1           <== Drop file location
  231.      WCS Software BBS               <== BBS Name
  232.      Rob Williams                   <== Sysop Name
  233.      0                              <== Locked baud rate
  234.      C:\WC30\BULL\BULL10.BBS        <== ASCII bulletin
  235.      C:\WC30\BULL\BULL10.SCR        <== ANSI bulletin
  236.      C:\DOORS\COMMENTS.DRS          <== Comments to Sysop File
  237.      10                             <== # of questions per day
  238.      2                              <== Extra days allowed for make up days
  239.      10                             <== Day to start make up days
  240.      A                              <== Write a log file (See Below)
  241.      By WCS Software                <== Donated by line
  242.      Computers Name                 <== Name as you want it to appear for
  243.                                         computer opponent
  244.      Y                              <== InterBBS Play (Y or N)
  245.      ************************************************************************
  246.      ** IMPORTANT - Even if the game is not registered, the last  three    **
  247.      ** lines must exist, or the game will not run.  You will get an error **
  248.      ** when the game starts up.                                           **
  249.      ************************************************************************
  250.  
  251.      On line 11, the valid options for a log file are:
  252.         - P for Play log ONLY  (BATTLE.nodenumber)
  253.         - N for No logs
  254.         - C for Comments log ONLY (COMMENTS.MSG)
  255.         - A for ALL Logs (play log and comment log)
  256.  
  257.      Battle Trip can be run locally without a door data file (handy
  258.      for the sysop to use the door without logging on to the BBS) by
  259.      specifying /L after the  configuration  file  parameter in  the  DOS 
  260.      command line.  BT will request you to enter your name before running
  261.      the door.
  262.  
  263.      To play the game in Multiuser mode, you must have a registered multinode 
  264.      copy,and DOS SHARE must be loaded.  If these two things are not done,  
  265.      the game will display a message if you try to run multinode.
  266.  
  267.      Nonstandard IRQs can be used by specifying the IRQ number after the 
  268.      "config" parameter in the command line used to run the door as
  269.      follows:
  270.  
  271.      BATTLE BATTLE.CFG 4
  272.  
  273.               Setting up Battle Trip for Multinode Play
  274.               -----------------------------------------
  275.  
  276.     In order to set Battle Trip up for multinode play, you need to create a
  277.     .cfg file for each node that will be using the game.  The .cfg files
  278.     will be similar, except that lines 2 and possibly 5 will be different.
  279.     Line 2 is the location of the door drop file.  This needs to be unique
  280.     for each node that runs the game.  Line 5 is the locked baud rate for
  281.     the node.  If you have nodes that are locked at different rates, then
  282.     this line may be different for different nodes.  For example, the
  283.     configuration file for node 1 (BATTLE.CF1) might look like this:
  284.  
  285.       GAP
  286.       H:\WILDCAT\WCWORK\NODE1     <=== Notice this is the node 1 directory
  287.       Williams Computer Services BBS
  288.       Rob Williams
  289.       19200
  290.       [etc].....
  291.  
  292.     And the configuration file for node 2 (BATTLE.CF2) might look like this:
  293.  
  294.       GAP
  295.       H:\WILDCAT\WCWORK\NODE2     <=== Notice this is the node 2 directory
  296.       Williams Computer Services BBS
  297.       Rob Williams
  298.       19200
  299.       [etc].....
  300.  
  301.     You will also need to set an environment variable to tell the program
  302.     what node it is currently running on.  Since I run Wildcat, I call
  303.     this variable WCNODEID.  In my .BAT file that calls the BBS, I set the
  304.     WCNODEID to whatever node is running.  You can use wahtever name you
  305.     wish, it just needs to be a unique node ID.
  306.  
  307.     Next, in the batch file that calls BT, you would change the sample.bat
  308.     that is included with this archive to look like this:
  309.  
  310.        CD\BATTLE
  311.        BATTLE BATTLE.CF%WCNODEID%
  312.  
  313.     What this will do, is when the game is started, it will look for the
  314.     WCNODEID (or whatever you called it), and append that to BATTLE.CF.  So
  315.     when the game runs, and you run it from node 1 say, it will use .cfg file
  316.     BATTLE.CF1.
  317.  
  318.     Hopefully, I have not totally confused you on how to set the door up for
  319.     mult-node use.  If you have questions on environment variables, refer
  320.     to your DOS manual.
  321.  
  322.    **************************************************************************
  323.    ** Running this game on more than a single node requires a Multi-Node   **
  324.    ** Key.  When running in Evaluation mode, only one (1) Node will be able**
  325.    ** to access the door at a time.                                        **
  326.    **************************************************************************
  327.  
  328.  
  329.                             Playing the Game
  330.                             ----------------
  331.  
  332.      Battle Trip is based on the card game Mille Borne.  When you enter the
  333.      door, you come to a menu of four options.  They are:
  334.  
  335.        P)lay Battle Trip - Starts the game
  336.        H)igh scores - Shows the high score bulletin
  337.        I)nstructions - Displays this file
  338.        Q)uit - Exits the game
  339.  
  340.  
  341.      Available Keys
  342.      --------------
  343.      After choosing the "P" option from the main menu, you are brought to the
  344.      main play screen.  From this screen there are four options:
  345.  
  346.        P)lay card - To play a card from your hand
  347.        D)iscard - To discard a card from your hand
  348.        C)oup Fourre - To play a safety on a hazard on your battle pile
  349.        R)edraw Screen - Redraws the screen if you get line noise, etc.
  350.        H)igh scores - Shows the high score bulletin
  351.        I)nstructions - Displays this file
  352.        Q)uit - Exits the game
  353.  
  354.      Parts of the Game
  355.      -----------------
  356.      There are four different types of cards in the game.
  357.      Hazards - Out of gas, Flat Tire, Accident, Speed Limit, Stop
  358.      Remedies - Gasoline, Spare Tire, Repairs, End of Limit, Roll
  359.      Safeties - Extra Tank, Puncture Proof, Driving Ace, Right of Way
  360.      Distance - 200, 100 75, 50, 25 miles
  361.  
  362.      The board is laid out as follows:
  363.      Battle Pile : This is where you play hazards (except for speed limits)
  364.                    on the computers pile, and remedies on your pile.  To
  365.                    play a distance card, you must have a roll card on top
  366.                    of your battle pile.
  367.      Speed Pile  : This is where you play speed limits (on the computers
  368.                    pile), and end of limits (on your pile)
  369.      Safety      : This is where you play any safety cards you have.  Once
  370.                    you play a safety card, the computer cannot play the
  371.                    associated hazard card.
  372.      Distance Pile-You cannot see these stacks, but you do see the total
  373.                    distance you have travelled under Total Miles.
  374.  
  375.      The object of the game is to "travel" 1000 miles before the computer does.
  376.      To play miles, you must have a Roll card on the top of your battle pile.
  377.      If you have a speed limit on your speed pile, you cannot travel any
  378.      further than 50 miles in a trip.
  379.  
  380.      During each turn, you will draw a card from the pile, and then either
  381.      P)lay, D)iscard, or C)oup Fourre a card.  To start, you need to play a
  382.      Roll card, then you can play distance cards as long as you have a roll
  383.      card on top of your battle pile.
  384.  
  385.      If you have played all your games for the day, you will be asked if you
  386.      want to view the high scores.  Then you will be returned to the BBS.
  387.  
  388.  
  389.      Scoring
  390.      -------
  391.      For each game, you are scored as follows:
  392.  
  393.      Miles Played    : As shown
  394.      Safeties Played : 100 for each safety played
  395.      Coup Fourees    : 300 for each safety that was coup foureed
  396.      Trip Completed  : 400 points for completing the trip
  397.      Safe Trip       : 300 points if no 200 mile cards were played
  398.      All safeties    : 300 points if you play all 4 safeties
  399.      Shut Out        : 500 points if you complete trip and computer has 0 miles
  400.  
  401.      When you go into the door, you will see an opening screen, it will
  402.      wait for you to press a key, then show you the main menu.  From here,
  403.      there are four options.  P will take you to the playing screen, H will
  404.      show you the high score list, I will show you a help file for playing
  405.      the game, and Q will return you to the BBS.
  406.  
  407.      The first time a player plays the game each month, the system will
  408.      automatically reset the player statistics.  This process should not
  409.      take more than a few seconds, and is automatic, so no intervention
  410.      from the Sysop is necessary.
  411.  
  412.                            Make-Up Days Explanation
  413.                            ------------------------
  414.  
  415.      The make up days feature warrants a little more explanation here.
  416.      When the game is registered, after you have played your game for today,
  417.      it will check to see if make up days has been enabled (start day < 31).
  418.      If today is greater than the start day, and the total number of days you
  419.      have played is not greater than what was specified in the .cfg file, it
  420.      will ask you if you want to play a make up day.  It will then show a
  421.      calendar of days for the current month.  Days that you have played will
  422.      show up in red with an x, playable days will show up in green with an o.
  423.      Choose a valid date (one with an o, within the current month), and you
  424.      will start another days game.  If you changed your mind and do not want
  425.      to play a make up day, enter 99, and you will be asked if you want to
  426.      view the high scores, then be returned to the BBS.
  427.                             
  428.                               Special Keys
  429.                               ------------
  430.                                     
  431.      While BT is running, the sysop can press certain special keys to
  432.      perform a variety of functions.   The following is a list of the
  433.      functions that the special keys perform:
  434.  
  435.      Key(s)              Function
  436.  
  437.      HOME                Toggles between the user  status window and a help
  438.                          display that lists the special keys.
  439.  
  440.      F6                  Takes 5 minutes away from the caller.
  441.                          NOTE:  This will NOT be returned to BBS.
  442.  
  443.      F7                  Gives 5 minutes to the caller.
  444.                          NOTE:  This will NOT be returned to the BBS.
  445.  
  446.      F9                  Quit the door and return the caller to the BBS.
  447.  
  448.      F10                 Enter  chat mode.  Pressing the  ESC key exits the
  449.                          chat mode.
  450.  
  451.      Alt+D               Drop to DOS.
  452.  
  453.                                  
  454.                                 Support
  455.                                 -------
  456.  
  457.      If you have problems, I will try and help as best I can, whether you
  458.      are registered or not.  Registered users will get priority over non-
  459.      registered users, though.  You may get help with problems by calling 
  460.      Williams Computer Services BBS at (503) 631-8439, or by writing to 
  461.      the author at the following addresses:
  462.  
  463.      FIDO      : 1:105/278
  464.  
  465.      Internet  : rob@wcs.org
  466.  
  467.      US Mail:
  468.  
  469.           Rob Williams
  470.           18370 S. Henrici Road
  471.           Oregon City, OR 97045
  472.  
  473.  
  474.                          Registering Battle Trip
  475.                       -----------------------------
  476.  
  477.      Registration of Battle Trip is only $15.00 for single node
  478.      or $20.00 for Multi-Node.   Please use the form in the file
  479.      REGISTER.FRM.   When  you register,  you will receive a registration
  480.      key that will turn your version into a registered version.
  481.  
  482.      Registered users will have access to the special area of the support
  483.      BBS for additional questions, and also be able to add new questions,
  484.      edit questions and users, print questions and users, and import and
  485.      export questions.
  486.  
  487.  
  488.         ***** ALL UPDATES ARE FREE FOR THE LIFE OF THE PROGRAM *****
  489.  
  490.                             Acknowledgements
  491.                             ----------------
  492.  
  493.  Thanks go to the following people/companies (Listed in no particular order):
  494.  
  495.           - Mustang Software for creating Wildcat!
  496.           - Randy Hunt and Mark Goodwin for creating RMDoor which was used
  497.             to create this game.
  498.           - Mike Jordan for his help with some of the routines, and for the
  499.             idea of the make up days, and also help in testing, and his help
  500.             in helping me get started in door programming.
  501.           - Andy Stewart for his programming help, and also for creating the
  502.             main play screen.
  503.           - Marcus and Ronda Eikenberry for their help in testing and finding
  504.             a few stubborn bugs.
  505.           - Gayle Davis and all the people that have contributed to the
  506.             SWAG archives.  I have used various snippets from those
  507.             archives, as well as them giving me good ideas on how to
  508.             proceed next.  Thank you.
  509.           - Matt Somerville for writing the help screen and helping with the
  510.             flow/play of the game (as well as rules).  Also, BIG thanks
  511.             for helping test the InterBBS play (a lot of messages went back
  512.             and forth testing it...<Grin>)
  513.           - A Big THANK YOU to all my beta testers:
  514.                Matt Somerville at 1:2250/8
  515.                Andy Stewart
  516.                Mike Maggi at 1:132/181
  517.                Ken Foster at 1:361/205
  518.  
  519.  
  520. There are probably more people that I have forgotten, but these have been
  521. the most instrumental in the writing of this program.
  522.  
  523.